home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lantools / lsnov / ls.doc next >
Encoding:
Text File  |  1987-04-01  |  5.4 KB  |  149 lines
  1.                LS -- A Directory Utility
  2.  
  3.                   Author: Gavin Adams
  4.  
  5.                  March 31, 1987
  6.  
  7.                  Version 1.00
  8.  
  9. Description:    LS is an enhanced directory utility that is superior to the
  10.         MS-DOS "DIR" command.  LS sorts the files alphabetically,
  11.         lays the files in columns so that more files can be seen on
  12.         the screen at the same time, and other features.
  13.  
  14.         LS was written after another program of the same name for
  15.         MS-DOS (IBM compatible really) that wouldn't require the
  16.         ANSI.SYS driver to be loaded.  Also added is a easier to read
  17.         "long" listing of files, and a nifty column for attributes
  18.         including the SHAREABLE attribute for Novell Netware files.
  19.  
  20.         The program was written in Microsoft C 4.00, on an Everex
  21.         System 180 (AT compatible), with testing done on a Novell
  22.         Advanced Netware SFT Level I, and PC-DOS 3.10.    If anyone
  23.         has any problems running LS under a different version of DOS,
  24.         or a different network O/S, I would appreciate the feedback
  25.         (See Contacting Author at bottom of docs).
  26.  
  27. Requirements:    IBM/PC,XT,AT or Compatible Computer
  28.         1 DSDD Disk Drive (Hard Disk Recommended)
  29.         Monochrome, CGA, or EGA Video Display
  30.         128K RAM
  31.         MS-DOS or PC-DOS version 2.10 or higher
  32.  
  33.  
  34. Installation/
  35. Operation:    To install LS, simply copy the file LS.EXE to the drive/
  36.         directory that you normally put you program files in.  LS
  37.         runs quite fast off of a hard disk, running it off of a
  38.         floppy drive could be a little slower.    Floppy owners with
  39.         a RAM drive may put LS there without any problems.
  40.  
  41.            The format for LS is:
  42.  
  43.             ls [-options] filename
  44.  
  45.         Options and the filename may be placed anywhere on the com-
  46.         mand line and in any order.  An option must have a leading
  47.         - (dash) character.  The filename spec is the same as for
  48.         the normal MS-DOS directory command.  Even though more then
  49.         one filespec can be listed, only the LAST given filespec will
  50.         be used.  Here are some examples:
  51.  
  52.             All files with .c extent, extended listing,
  53.             send to printer:
  54.  
  55.             C>ls -l *.c -p
  56.  
  57.             C>ls -lp *.c
  58.  
  59.             C>ls *.c -pl
  60.  
  61. Options:    Without options, LS will display the files requested in a
  62.         1 to 5 column format, sorted alphabetically, and broken by
  63.         pages.    The following options tell LS to either display the
  64.         files in a different order, or to sort files in a different
  65.         matter.
  66.  
  67.         -?    If this is option is used, LS will give a short list-
  68.               ing of the options available to LS and the current
  69.               version number.  No files will be displayed with op-
  70.               tion.
  71.  
  72.         -a    All files display.  Normally, LS will only show files
  73.               that the MS-DOS DIR command shows.  With this option,
  74.               hidden and system files will also be shown, along with
  75.               the current and parent directories ("." and "..").
  76.  
  77.         -c    Single column listing.  For those that prefer the di-
  78.               rectory to be displayed in one column.  Good if your
  79.               on an 40-column monitor also.
  80.  
  81.         -l    Long listing of files.  LS only show the name of the
  82.               file by default.    This option gives full information
  83.               on the file in the following format:
  84.  
  85.               filename      byte size   date  time    attributes
  86.  
  87.               Filename - Name of file specified
  88.               Byte size - Number of bytes long
  89.               Date - Last modified date
  90.               Time - Last modified time
  91.               Attributes -   rw - read/write
  92.                      ro - read/only   (no modify)
  93.                      a    - archive
  94.                      y    - system file (i.e. IBMBIOS.COM)
  95.                      d    - subdirectory
  96.                      v    - volume label of disk
  97.                      h    - hidden file
  98.                      s    - shareable (Novell only)
  99.                      u    - unused (may be used by other O/S)
  100.  
  101.         -p    Re-direct output to printer.  NOTE: the MS-DOS redirec-
  102.               tion command (>) can also be used to re-direct output
  103.               to either the printer or a file.
  104.  
  105.         -r    Reverse sort of files.  This will reverse the sort
  106.               (alpha or by date/time) in the opposite order (i.e.
  107.               A-Z would be Z-A or Old/New would be New/Old).
  108.  
  109.         -t    Date/Time sort of files.    Instead of sorting by alpha,
  110.               the files will be sorted by the time date stamp.
  111.  
  112.         -u    Disk usage report of drive.  This will show the total
  113.               bytes of the files listed, and the total remaining
  114.               room on the drive where the files exist.
  115.  
  116. Shareware:    This program is copyrighted, and is not public domain.
  117.         If you use this program, please send $5.00 to the address
  118.         below.    If not, either erase it or give it to someone else
  119.         to see if they like it.
  120.  
  121.         You may freely distribute this program as long as you do
  122.         not modify either the code or this doc file.  Also, both the
  123.         program file and documentation must be kept together.
  124.  
  125.         Anyone who does register (and sends in $5.00) will get up-
  126.         dates for 1 (one) year from the date I receive the registra-
  127.         tion.  You will also receive any other utilities that I re-
  128.         lease under the classification of "Utilities".
  129.  
  130. Contacting
  131. Author:     To either send in your registration, comments, questions, pos-
  132.         sible bugs and such, please contact in the following ways.
  133.  
  134.         Compuserve:        PPN  [72167,760]  Gavin Adams
  135.  
  136.         West Coast / BBS's:     C.A.A.   (702)-731-3178
  137.                     Leave E-Mail for Gavin Adams
  138.  
  139.         or write:    Gavin Adams
  140.                 304 Orland #39
  141.                 Las Vegas,  NV 89107
  142.                 (702) 877-1392
  143.  
  144.         I would deeply appreciate any comments on what you like and
  145.         don't like about the program, bugs you encounter, or just a
  146.         card showing that you has seen my software.
  147.  
  148.            Until the next program...
  149.